home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 2002 November / SGI Freeware 2002 November - Disc 1.iso / dist / fw_apache2.idb / usr / freeware / catman / a_man / cat8 / apachectl.Z / apachectl
Encoding:
Text File  |  2002-07-08  |  3.5 KB  |  88 lines
  1. apachectl(1)                         apachectl(1)
  2.  
  3.  
  4.  
  5. NNAAMMEE
  6.        apachectl - Apache HTTP server control interface
  7.  
  8. SSYYNNOOPPSSIISS
  9.        aappaacchheeccttll _c_o_m_m_a_n_d [...]
  10.  
  11. DDEESSCCRRIIPPTTIIOONN
  12.        aappaacchheeccttll  is a front end to the    Apache HyperText Transfer
  13.        Protocol    (HTTP) server.    It is designed to help the admin
  14.        istrator     control the functioning of the    Apache hhttttppdd dae
  15.        mon.
  16.  
  17.        NNOOTTEE:: If    your Apache installation uses non-standard paths,
  18.        you  will  need    to  edit  the aappaacchheeccttll    script to set the
  19.        appropriate paths to your PID file and your hhttttppdd  binary.
  20.        See the comments    in the script for details.
  21.  
  22.        The  aappaacchheeccttll  script  returns a 0 exit    value on success,
  23.        and >0 if an error occurs.  For    more  details,    view  the
  24.        comments    in the script.
  25.  
  26.        Full    documentation   for   Apache   is   available   at
  27.        hhttttpp::////hhttttppdd..aappaacchhee..oorrgg//
  28.  
  29. OOPPTTIIOONNSS
  30.        The _c_o_m_m_a_n_d can be  any    one  or     more  of  the    following
  31.        options:
  32.  
  33.        ssttaarrtt       Start the Apache daemon.  Gives an error if it
  34.            is already running.
  35.  
  36.        ssttoopp       Stops the Apache daemon.
  37.  
  38.        rreessttaarrtt       Restarts the    Apache daemon  by  sending  it    a
  39.            SIGHUP.   If     the daemon is not running, it is
  40.            started.  This  command  automatically  checks
  41.            the    configuration files via    ccoonnffiiggtteesstt before
  42.            initiating the restart  to  make  sure  Apache
  43.            doesn't die.
  44.  
  45.        ffuullllssttaattuuss  Displays a full status report from mmoodd__ssttaattuuss..
  46.            For this to work, you need to have  mod_status
  47.            enabled   on     your  server  and  a  text-based
  48.            browser such    as _l_y_n_x    available on your system.
  49.            The    URL  used to access the    status report can
  50.            be set by editing the  SSTTAATTUUSSUURRLL  variable  in
  51.            the script.
  52.  
  53.        ssttaattuuss       Displays  a    brief  status report.  Similar to
  54.            the fullstatus option, except that the list of
  55.            requests currently being served is omitted.
  56.  
  57.        ggrraacceeffuull       Gracefully restarts the Apache daemon by send
  58.            ing it a SIGUSR1.  If the daemon is    not  run
  59.            ning, it is started.     This differs from a nor
  60.            mal restart in that currently open connections
  61.            are    not  aborted.    A side effect is that old
  62.            log files  will  not     be  closed  immediately.
  63.            This     means    that  if  used    in a log rotation
  64.            script, a substantial delay may  be    necessary
  65.            to  ensure  that  the old log files are closed
  66.            before   processing     them.      This      command
  67.            automatically  checks  the configuration files
  68.            via ccoonnffiiggtteesstt before initiating  the  restart
  69.            to  make  sure Apache doesn't die.  On certain
  70.            platforms that do not allow SIGUSR1 to be used
  71.            for    a graceful restart, an alternative signal
  72.            may be used (such as    SIGWINCH).  graceful will
  73.            send    the right signal for your platform.
  74.  
  75.        ccoonnffiiggtteesstt  Run    a  configuration  file    syntax    test.  It
  76.            parses  the    configuration  files  and  either
  77.            reports  SSyynnttaaxx  OOkk    or  detailed  information
  78.            about the particular    syntax error.
  79.  
  80.        hheellpp       Displays a short help message.
  81.  
  82. SSEEEE AALLSSOO
  83.        hhttttppdd((88))
  84.  
  85.  
  86.  
  87.               September 1997         apachectl(1)
  88.